home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 18 / CU Amiga Magazine's Super CD-ROM 18 (1997)(EMAP Images)(GB)[!][issue 1998-01].iso / CUCD / Utilities / StartupSelector / Docs / English / StartupSelector.doc < prev    next >
Encoding:
Text File  |  1997-09-11  |  16.0 KB  |  479 lines
  1.                   --------------------------------------
  2.                   * Moonchild Prod. proudly presents : *
  3.                   --------------------------------------
  4.  
  5.                           /-=-=-=-=-=-=-=-=-=-=-\
  6.                          < STARTUPSELECTOR  2.1  >
  7.                           \-=-=-=-=-=-=-=-=-=-=-/
  8.  
  9.                               1. Copyrights
  10.  
  11.                               2. Introduction
  12.  
  13.                               3. Requierements
  14.  
  15.                               4. Installation 
  16.  
  17.                               5. Usage
  18.  
  19.                               6. Greets
  20.  
  21.                               7. The authors
  22.  
  23.                               8. The futur
  24.  
  25.                               9. History
  26.  
  27.                             10. Hints and tips
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39. 1. Copyrights :
  40. ***************
  41.  
  42.  The program and its source in this archive are both  Copyright  (c)  1996-97
  43.  OLIVERES 'Moonchild' Jean-Marc and GUENOT 'RaphE' Raphaël.
  44.  
  45.  You can freely modify the program's source. The only thing I asked you is to
  46.  send me a version with your modifications and don't forget to credit me.
  47.  
  48.  Authorization is  granted  to  distribute  copies  of  this  manual  if  the
  49.  copyright notice and this authorization notice are in all the copies.
  50.  
  51.  No  warranty  are done for a 100% perfect program describe in this file. You
  52.  use your equipment at your own risks. The author can't be  made  responsible
  53.  for any damage caused by the use of this program.
  54.  
  55.  You  can  distribute this archive freely but it is always Copyright OLIVERES
  56.  Jean-Marc. You can freely copy it as long as you don't  ask  more  than  the
  57.  cost of a single copy.
  58.  
  59.  Authorization is granted to include this archive in the DP collections.
  60.  
  61.  If  you  want  to  distribute  this  archive, you must use archives from the
  62.  original distribution.
  63.  
  64.  
  65. 2. Introduction :
  66. *****************
  67.  
  68.  Welcome to the fabulous world of startup-sequence selectors.
  69.  
  70.  With this little program, you'll have the possibility to execute  differents
  71.  startup files, according to your wishes.
  72.  
  73.  You just have to write as many startup files as you want to begin your Amiga
  74.  session in the way you like because you made it.
  75.  
  76.  The program will show you the list of all your files and you'll just have to
  77.  click on the name you have choosen to execute this startup-sequence file.
  78.  
  79.  You can also deactivate the WBStartup directory and the User-Startup file to
  80.  gain some space memory.
  81.  
  82.  You'll have the possibility to open a Shell, to edit or delete a script,  to
  83.  have sounds, to have icons with your scripts.
  84.  
  85.  If  you have WBStartup+ installed then a button will appear at the bottom of
  86.  the window and you'll have the possibility to call its Preferences program.
  87.  
  88.  Now you can save your last choosen file and your differents choices.
  89.  
  90.  There is a preferences program wich can be called either from  Workbench  or
  91.  from StartupSelector's menu.
  92.  
  93.  I hope it will be as usefull as it is for me and some of my friends.
  94.  
  95.  This  program  has  been written in the E language, and it's my first try of
  96.  programming on AMIGA. I hope you'll excuse some mistakes I could make in the
  97.  source structure.
  98.  
  99.  The source is in the source directory.
  100.  
  101.  Note : 
  102.  ------
  103.  
  104.  StartupSelector is Giftware. Send me what you want if you think this program
  105.  is  usefull  for  you  (a postcard of your country, a disk full of mangas, a
  106.  chocolate box, an PPC Amiga ...). There's no reason to make it Shareware.  I
  107.  spent  a  lot  of time on it but no money was used. Thanks for all those who
  108.  will send me something.
  109.  
  110.  
  111. 3. Requierements :
  112. ******************
  113.  
  114.  To run this program you need :
  115.  
  116.   - An AMIGA :-)
  117.  
  118.   - The Reqtools.library Copyright © Nico François (optional)
  119.  
  120.   - The LoadWB command in the C: directory
  121.  
  122.   - The Execute command in the C: directory
  123.  
  124.   - The WBStartup+ program Copyright © 1996 John Hughes (optional)
  125.  
  126.  The program was tested and written with an Amiga 1200 with an accelerator card
  127. Microbotics 68030/50Mhz an a 520 Mo HD and 6 MO of RAM.
  128.  
  129.  You need an Amiga with the release 2.0+ of the Workbench.
  130.  
  131.  
  132. 4. Installation :
  133. *****************
  134.  
  135.  Enter in the 'Install' directory and execute the script you want to  install
  136.  Startup-Selector on your HD.
  137.  
  138.  For those who want to do it by hand, here is the method to follow.
  139.  
  140.  To  install it, you just have to copy it where you want on your HD. The more
  141.  simple is to copy it in the C: directory.
  142.  
  143.  The only thing you must do is to put the 'sounds' directory in the same  one
  144.  where  you  have installed Startup-Selector. If not, no sound will be played
  145.  but the program will work.
  146.  
  147.  Next, make a dir called 'Start' in S: because you'll put your scripts in it.
  148.  You may change this if you want (see the 'Startup' section).
  149.  
  150.  Then  edit a small Startup-Sequence with the 'Setpatch' command and the path
  151.  to where you've put 'StartupSelector' without the 'Run' command.  This  file
  152.  become the one executed when you switch on your Amiga.
  153.  
  154.  Your  original  Startup-Sequence  file MUST be copied in the directory where
  155.  you'll put all your scripts (default is 'S:Start/'). You must delete or  put
  156.  into comment (';') the line with the 'Setpatch' command.
  157.  
  158.  NOTE : make a secure copy of your original Startup-Sequence file and keep it
  159.  somewhere (ie Startup-Sequence.org).
  160.  
  161.  Copy the preferences program in your 'Prefs' directory.
  162.  
  163.  Simple isn't it ? :-) no ?... it is !!!
  164.  
  165.  
  166. 5. Usage :
  167. **********
  168.  
  169.  My Startup-Sequence file looks like this :
  170.  
  171.  Assign c: hd0:Cmds ADD
  172.  C:Setpatch QUIET           /* IMPORTANT */
  173.  autoxa > nil:
  174.  startupselector            /* IMPORTANT */
  175.  
  176.  IF EXISTS S:User-Startup   /* These lines are here
  177.   Execute S:User-Startup    /* for Installer to find
  178.  EndIF                      /* your User-Startup
  179.  
  180.  Before running 'StartupSelector', run his preferences program to  make  your
  181.  settings like the path to your scripts and the default script.
  182.  
  183.  More,  you can deactivate the WBStartup directory and the User-Startup file.
  184.  The program just rename them as 'WBStartupOld' and as 'User-StartupOld'.
  185.  
  186.  You don't have to worry about the directory because  the  first  thing  that
  187.  StartupSelector  do  at the begining is to rename the directory and the file
  188.  in the right way.
  189.  
  190.  To call it, simply press the qualifier button you choose  at  the  start  of
  191.  your  Amiga  session  until  the window appears. If not, It'll automatically
  192.  execute the Startup-Sequence file.  So  don't  forget  to  put  it  in  your
  193.  directory :-).
  194.  
  195.  At  the  window  opening,  it will let you the choice between all your files
  196.  with the Startup-Sequence file.
  197.  
  198.  With the version 2.0 you can save your  preferences  to  restart  with  this
  199.  configuration without opening the window of 'StartupSelector'. A file called
  200.  'startupselector.prefs' will be written in your S: directory.
  201.  
  202.  You can edit it by hand with the text editor of your choice.
  203.  
  204.  If you have the WBStartup+ program installed a button  will  appear  at  the
  205.  bottom  of the window. If you click it you will call the Preferences program
  206.  of WBStartup+. If it is not installed nothing will  appear.  StartupSelector
  207.  will  search  in  the  'SYS:prefs'  directory  to  find  the  program called
  208.  'WBStartup+Prefs'.
  209.  
  210.  More, when the window opened, the default script will be highlighted.
  211.  
  212.  The  closing window button lets you start with the last saved script with or
  213.  without modifying the settings and  will  save  your  choices  if  you  have
  214.  checked the right option.
  215.  
  216.  Menu description :
  217.  ------------------
  218.  
  219.  Project
  220.  |------
  221.  |-About             -> Informations about the program
  222.  |-Preferences       -> Call the preferences program
  223.  |-NewCli            -> Open a CLI
  224.  |-Quit              -> Exit the program without running a script or saving
  225.                         your choices (even if checked)
  226.  Commands
  227.  |-------
  228.  |-Edit
  229.  | |-New file            -> Edit a new script with an external text editor
  230.  | |-Highlighted script  -> Edit an existing script
  231.  |
  232.  |-Delete                -> Delete a script from the list and directory
  233.  
  234.  Preferences file description : (StartupSelector.prefs)
  235.  ------------------------------
  236.  
  237. ASCIIFP         ; I must be the first line. Don't modify me.
  238. $VER: StartupSelectorPrefs 1.1     ; version number
  239. Double click ? YES                 ; way of executing script
  240. Window always opened ? NO          ; window automatically opened
  241. Sounds ? YES                       ; if you want sounds
  242. Path to editor: hd1:misc/ced3.5    ; guess what ?
  243. Startups directory: S:Start/       ; startups files directory
  244. Default startup: startup-sequence  ; default executing script
  245. Language : français                ; the language for the catalog
  246. Qualifier: LEFTBUTTON              ; way of calling the program
  247. Screen mode: $29000                ; screen type (depends on monitors)
  248. Font: topaz.font                   ; font choice
  249. Font size: 8                       ; font size choice
  250. Disable User-Startup ? NO          ; guess what ?
  251. Disable WBStartup ? NO             ; same as before ...
  252.  
  253.  The preferences program let you initialized  all  this  settings.  With  the
  254.  'Use'  button,  you have the possibility to use this settings without saving
  255.  the preferences. This  is  usefull  because  it  permit  you  to  have  more
  256.  differents  scripts  directory.  you are no more limited in script number or
  257.  directory number. The program  can  handle  up  to  32000  scripts  in  each
  258.  directory.
  259.  
  260.  Example :
  261.  
  262.  Your  environment  initialization scripts will be in 'S:Start'. Your scripts
  263.  for running your professionnals softs will be in 'Work:Start'. Your  scripts
  264.  to launch games will be in 'Games:Start'.
  265.  
  266.  The possibilities are only limited by your imagination (a script wich launch
  267.  a memory eating demo, a script doing a slide-show of your pictures...).
  268.  
  269.  
  270. 6. Greets :
  271. ***********
  272.  
  273.  First I would like to thank Wouter  Van  Oortmerssen  for  his  wonderful  E
  274.  language.
  275.  
  276.  I  would  like  to thank Jason R. Hulance for his "Beginer.Guide" wich is of
  277.  great help for new developers.
  278.  
  279.  Thanks to John Hughes for  the  WBStartup+  program.  I  used  your  program
  280.  because  some  people tell me to include it in my program. Sorry not to have
  281.  demand you for an authorization. I hope you don't mind :-).
  282.  
  283.  Hello to Philippe 'Elwood' Ferrucci for his help during the finalisation  of
  284.  the 1.0 and 1.05 versions.
  285.  
  286.  Last but not least, hellos goes to : 
  287.  
  288.    Alamelama Dominique    (merci pour la réparation de mon Amiga)
  289.    Delantes 'HCL' Mathias (tes logiciels sont rigolos)
  290.    Daniel de JANAL LYON   (l'idée de ce logiciel était bonne)
  291.    Saillour Pierre        (range ton disque dur vieux !)
  292.    Mearini Renaud         (tu vas faire un malheur avec "Ben" et "Speed")
  293.    Arnaud Yvan            (vive le CD-ROM)
  294.  
  295.  And of course, hello at the Amiga scene.
  296.  
  297.  WE ARE BACK FOR THE FUTUR !
  298.  
  299.  
  300. 7. The authors :
  301. ****************
  302.  
  303.  You can join us for comments or ideas at the following :
  304.  
  305.  
  306.      OLIVERES Jean-Marc                      GUENOT Raphaël
  307.      12, Rue Charles Porcher                 22, Rue Jamen Grand
  308.      69009 LYON                              69300 CALUIRE
  309.      FRANCE                                  FRANCE
  310.  
  311.      E-Mail  : elwood@neptune.fr             raphe@chezmoi.surle.net
  312.      Subject : Moon                          Startup-Selector
  313.  
  314.  Excuse me for my bad english but I'm French.
  315.  
  316.  
  317. 8. The futur :
  318. **************
  319.  
  320.  - Put a backdrop screen picture.
  321.  - Let the user choose between some backdrop patterns.
  322.  - Create a new look for the GUI.
  323.  - Updated the preferences program.
  324.  - More catalogs (your translations are welcome see E-mail).
  325.  - Removed possibly bugs... :-(
  326.  - Let the user choose between a listview whith only icons
  327.                                                 icons and text
  328.                                                 only text.
  329.  - 3D raytraced gadgets
  330.    lightsourced menus
  331.    gouraud shaded mouse pointer !!! ;-)
  332.  
  333.  If you want to have new feature in it, you can contact me by mail or E-mail.
  334.  I will try to include the idea if it seems usefull...
  335.  
  336. 9. History :
  337. ************
  338.  
  339. Internals versions : 06.20.96 - 07.08.96
  340. --------------------
  341.  
  342.  Version 0.1 :
  343.  
  344.  - just a simple window at the start of the Amiga session with  the  list  of
  345.  the files to execute.
  346.  
  347.  Version 1.0 :
  348.  
  349.  - the selected file is executed.
  350.  - programm run at each Amiga session.
  351.  - it can't be included in the Startup-Sequence.
  352.  
  353.  Version 1.01 :
  354.  
  355.  - called by the left mouse button.
  356.  - can be put in the Startup-Sequence.
  357.  - but continue with it at the end of the script.
  358.  
  359.  Version 1.02 :
  360.  
  361.  - close the Startup-Sequence (bug).
  362.  - execute only the choosen script.
  363.  
  364.  Version 1.03 :
  365.  
  366.  - bug in the closing of the Startup-Sequence not fixed.
  367.  - possibility to deactivate the WBStartup directory.
  368.  - window centered on the opening screen.
  369.  
  370. Externals releases : 07.16.96
  371. --------------------
  372.  
  373.  Version 1.04 :
  374.  
  375.  - added argument for the path of the scripts.
  376.  - program launched from a small Startup-Séquence.
  377.  - execute the Startup-Sequence file if no LMB press.
  378.  - added menu.
  379.  - GUI looks better.
  380.  - some optimisations.
  381.  - first release.
  382.  - added alphabetical order.
  383.  - possibility to deactivate the User-Startup file.
  384.  - can open a CLI.
  385.  - fixed a bug with the possibility to deactivate the WBStartup directory
  386.    because it was running just in one way.
  387.  
  388.  Version 1.05 (09.07.96) :
  389.  
  390.  - replace buttons by a listview.
  391.  - no more file number limitation.
  392.  - better errors handler.
  393.  - removed an Enforcer hit in the menu.
  394.  
  395.  Version 1.1 (09.24.96) :
  396.  
  397.  - last script choosen saved.
  398.  - choices are saved too.
  399.  - some optimisations.
  400.  - run with or whithout the Reqtools.library.
  401.  - show the last saved script.
  402.  - detects and have the possibility to run the WBStartup+ preferences if
  403.    installed.
  404.  - auto-creation of the xx_log file the first time the program is ran.
  405.  - rewritten this doc to be clearer in the installation and startup sections.
  406.  
  407.  Version 1.2 (02.01.97) :
  408.  
  409.  - double-click to choose your script.
  410.  - removed a bug when a 'space' was in your script's name, because  it  won't
  411.  be launched.
  412.  
  413.  Version 1.2a (03.02.97) :
  414.  
  415.  - fixed a bug. Now the  reqtools.prefs  file  is  well  initialized  (Damian
  416.  Jurzysta  reported  it).
  417.  - now the .info and the .bak files are not shown anymore.
  418.  
  419.  Version 1.3 (05.19.97) :
  420.  
  421.  - text menu is now visible under WB 2.0.
  422.  - no more bevelboxes around the checkboxes text.
  423.  - text is now black and not white.
  424.  - no more mistake in the text of the Project menu.
  425.  - possibility to choose the key to open the window.
  426.  
  427.  Version 2.0 (07.13.97) :
  428.  
  429.  - no more argument.
  430.  - preferences program.
  431.  - choice between a simple or a double click to execute a script.
  432.  - choice of the screen resolution.
  433.  - possibility to make the window open without any call.
  434.  - new preferences file easyly editable.
  435.  - main window frozen when other window is open over it.
  436.  - screen close with checking of opened windows.
  437.  - preferences program can be called by the menu.
  438.  - respect of the 2.0 or 3.0 style on screen.
  439.  - and... hum... some little bugs :(
  440.  
  441.  Version 2.1 (09.11.97)  :
  442.  
  443.  - added some sound.
  444.  - possibility to choose the fonts.
  445.  - monitor detection.
  446.  - new menu 'Commands'.
  447.  - edit a script or a new file (with an external text editor).
  448.  - delete scripts.
  449.  - localisation.
  450.  - installer's script.
  451.  - doc written again.
  452.  - multiple scripts directory.
  453.  - icons can be put in listview.
  454.  - no more script name in the left part of the window.
  455.  - when the window opened the default script will be highlighted.
  456.  - optimizations.
  457.  - new 'Use' button in the preferences program.
  458.  - removed bugs... I hope so...
  459.  
  460. 10. Hints and tips :
  461. ********************
  462.  
  463. You can suppress the lines dealing with the User-Startup. But when  you  will
  464. install  a  program  using  an  Installer script, it will tell you to include
  465. these lines in your Startup-Sequence. If you refuse and after it  must  write
  466. some  assign  in  the  User-Startup,  it  will  write them at the end of your
  467. Startup- Sequence.
  468.  
  469. You can also use the end of your Startup-Sequence to write some  assign  wich
  470. will be executed just after Startup-Selector.
  471.  
  472. If  you  are  using an Overdrive-HD use a qualifier key which differ from the
  473. mouse (i.e LEFT-ALT). This will prevent you from a  message  telling  you  to
  474. insert the disk CC0:. (Thank to Kenneth Jonnsonn for reporting that :-))
  475.  
  476. To edit a script, you will use your favorite text editor. Don't forget, if it
  477. is necessary, to make the assign needed by it to work well at  the  beginning
  478. of your new Startup-Sequence.
  479.